home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / mac / files / sat / satra10.arc / SATRA.TXT < prev    next >
Text File  |  1989-07-06  |  7KB  |  223 lines
  1.             SATRA - SAtellite TRAcking
  2.             --------------------------
  3.  
  4.             by Jari Salminen, OH2BYQ
  5.  
  6.                    V1.0  June 5, 1989
  7.  
  8.  
  9.   I started writing SATRA as my first Windows application about two years ago.
  10. Since then it has been rewritten twice or three times as my knowledge about
  11. Windows has grown. It's quite well behaving now, but like in all good projects
  12. there is still lots to do.
  13.  
  14.   You can distribute and copy SATRA to NON COMMERCIAL purposes only in good
  15. ham spirit. If you want to contact me, try one of the following address:
  16.  
  17.       -    Jari Salminen
  18.     Kontulankaari 11 H 247
  19.     SF-00940 HELSINKI
  20.     FINLAND, EUROPE
  21.  
  22.  
  23.       -    USENET: jsa@otax.tky.hut.fi
  24.  
  25.  
  26. General information about using SATRA
  27. -------------------------------------
  28.  
  29. SATRA requires MS-Windows 2.0 or better. Mouse is not requiered.
  30. Use of math-coprocessor recommended, but not requiered.
  31.  
  32.  
  33. Files needed:
  34.     SATRA.EXE - the program
  35.     SATRA.QTH - QTH information
  36.     SATRA.SAT - satellite information
  37.     SATRA.MOD - optional mode information for satellites
  38.     WIN87EM.EXE - Windows floating point emulator library
  39.  
  40. SATRA uses coordinates in range: Longitude -180..180, Latitude -90..90.
  41.  
  42. Satellite information is shown in the bottom are of the window after
  43. the satellite is selected by clicking the satellite on the screen with
  44. mouse or using 'TAB' to scroll through satellites. When satellite is
  45. seleted, its name on map is inverted. When satellite is visible in
  46. your QTH, there is a little '+' character instead of square on the left
  47. side of satellite name and the name is printed in red.
  48.  
  49. Double click on satellite or 'Ctrl-T' for curretly selected satellite
  50. displays the tracking window and SATRA starts tracking that satellite.
  51.  
  52.  
  53. NOTE1: This version (V1.0) is coded for antenna rotating system by
  54. Timo Knuutila, OH1QC/OH2MAT. Future version will have a general interface
  55. where different systems can be easilly adapted.
  56.  
  57. NOTE2: Only one SATRA can run at a time (still some bugs with global handles
  58. or something ...)
  59.  
  60. NOTE3: Sorry about this short documentation, but I hope that using SATRA would
  61. be so simple that you don't need manual at all.
  62.  
  63.  
  64. Brief information about menu commands
  65. -------------------------------------
  66.  
  67. File - Load Satellites
  68.     Loads new satellite file. Satellite information must be in
  69.     "AMSAT-format":
  70.  
  71.     Satellite:      OSCAR 10   
  72.     Catalog number: 14129
  73.     Epoch time:     88178.59395153
  74.     Element set:    342
  75.     Inclination:    27.302600 deg
  76.     RA of node:     317.156900 deg
  77.     Eccentricity:   0.602864
  78.     Arg of perigee: 315.542500 deg
  79.     Mean anomaly:   9.422800 deg
  80.     Mean motion:    2.05879802   rev/day
  81.     Decay rate:     -8.10000000e-007 rev/day^2
  82.     Epoch rev:      989
  83.  
  84.     SATRA can handle up to 50 satellites at a time.
  85.  
  86. File - Load new QTH
  87.     Loads new QTH information. Format of the file is:
  88.  
  89.     # SATRA, QTH-info
  90.     # Name, Longitude (E+ W-), Latitude, Height (m from surface)
  91.     OH2TI 24.8 60.19 50
  92.  
  93.     Lines starting with '#' are comment lines
  94.  
  95.  
  96. Satellites - Select
  97.     Shows a dialog bos where all satellites are alphabetically ordered.
  98.     You can select satellites with mouse by clicking, or with keyboard
  99.     with arrow keys and space bar. To select multiple satellites hold
  100.     down shift key while clicking with mouse or ctrl-key while using
  101.     keyboard. 'Enter' is same as 'Ok', 'Esc' means 'Cancel', 'Alt-S'
  102.     is 'Select all' and 'Alt-C' 'Clear all'.
  103.  
  104. Satellites - Save as default set
  105.     Every time SATRA starts it looks from WIN.INI lines:
  106.  
  107.     [SATRA]
  108.     SatDefault=
  109.  
  110.     If after "SatDefault=" is list of satellite names separated with ';',
  111.     SATRA display those satellites on screen at start. You can save
  112.     the current satellite setup as default with this command.
  113.  
  114.  
  115. Map - World, Europe, North America, U.S.A.
  116.     Selects the display area of the map.
  117.  
  118. Map - Simple, Filled
  119.     Map drawing may be simple (just coastlines -> fast) or filled
  120.     (oceans are grayed -> slower).
  121.  
  122. Map - Lo-res, Med-res
  123.     Selects either low or medium resolution map.
  124.  
  125.     The default map mode could be in WIN.INI in line "Map=".
  126.     Mode is coded to three letters:
  127.     1st letter: W, E, N or U (World, Europe, etc.)
  128.     2nd letter: S or F (Simple or Filled)
  129.     3rd letter: L or M (Lo-res or Med-res)
  130.  
  131.     Default is WSL.
  132.  
  133.     Example:
  134.  
  135.     [SATRA]
  136.     Map=ESM
  137.  
  138.  
  139. Options - Step
  140.     This command selects the step mode and time interval.
  141.     When "Automatic" mode is on, time is incremented with values from
  142.     "Step Min" and "Step sec" controls. If "Real time" is on, time is
  143.     taken from PC. Then "Step Min" and "Step sec" tells the delay between
  144.     two calculation of satellite positions.
  145.  
  146.     NOTE! to get the correct UTC-time, you must have the DOS enviroment
  147.     variable "TZ" set to the time zome of your QTH.
  148.     Example: DOS command "set TZ=EET-2" sets East European time that
  149.     is two hours ahead GMT.
  150.  
  151. Options - New QTH
  152.     New QTH position could be selected with this command.
  153.  
  154. Options - Rec. Freq
  155.     Seletcs the receiving frequency for doppler calculations. This has
  156.     no meaning if satellite has correct frequency in SATRA.MOD file.
  157.  
  158. Options - Range Circle
  159.     Adds a range circle for selected satellite.
  160.  
  161. Options - Orbit!
  162.     Draws projection of satellites one full round around globe and
  163.     time when that round ends.
  164.  
  165. Step!
  166.          Starts stepping (= incrementing time and calculating new satellites
  167.     positions).
  168.  
  169. Stop!
  170.     Stops stepping.
  171.  
  172. Track!
  173.  
  174.     Opens up a tracking window. When there is no satellite to be tracked
  175.     ( the caption has no satellite name ), then scrollbars affect straight
  176.     to the direction values. If there is satellite to be tracked, then
  177.     scrollbars change the offset value that is added to the calculated
  178.     values.
  179.  
  180.     TILTED means that antenna is turn upside down so that satellite, which
  181.     normally would travels across the stop points of rotator, could be
  182.     tracked normally. The values in tracking window are the real values
  183.     where the antenna is pointing.
  184.  
  185.  
  186.  
  187. Format of the SATRA.MOD file
  188. ----------------------------
  189.  
  190. Example of SATRA.MOD file (that should say it all ...):
  191.  
  192. # SATRA.MOD
  193. # Satellite modes
  194. #
  195. # For MaxPhase the default value is 256.
  196. #
  197. # Mode: Name (StartPhase-EndPhase) U:123.123 D:123.123 R F
  198. # where fields are:
  199. #       Name = Mode name (or "Off")
  200. #       StartPhase = start phase of mode
  201. #       EndPhase = end phase of mode
  202. #
  203. #       U = Uplink frequency (MHz)
  204. #       D = Downlink freq.
  205. #
  206. #       R = Reversed freq. (when uplink increases, downlink decreases...)
  207. #         or
  208. #       F = Fixed freq.
  209. #
  210. Satellite: OSCAR 10
  211. MaxPhase: 256
  212. Mode: B (21-199) U:435.105 D:145.900 R
  213. Mode: Off (200-20)
  214.  
  215. Satellite: Oscar-13
  216. MaxPhase: 256
  217. Mode: B (21-199) U:435.508 D:145.890 R
  218. Mode: J (200-230) U:144.448 D:435.965 R
  219. Mode: L (231-2) U:1269.496 D:435.860 R
  220. Mode: Off (3-20)
  221.  
  222.  
  223.